<html>
<head><meta charset="utf-8"><title>Syntactic Descriptions Style Questions · t-lang/doc · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/237824-t-lang/doc/index.html">t-lang/doc</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/237824-t-lang/doc/topic/Syntactic.20Descriptions.20Style.20Questions.html">Syntactic Descriptions Style Questions</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="228110677"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/237824-t-lang/doc/topic/Syntactic%20Descriptions%20Style%20Questions/near/228110677" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> isHavvy <a href="https://rust-lang.github.io/zulip_archive/stream/237824-t-lang/doc/topic/Syntactic.20Descriptions.20Style.20Questions.html#228110677">(Feb 28 2021 at 06:43)</a>:</h4>
<p>We have paragraphs that are of the form:</p>
<div class="codehilite" data-code-language="markdown"><pre><span></span><code>The syntax for XYZ is a <span class="sb">`some token`</span>, and then a ABC, the ABCN, and then a PQR, the PQRN, and then <span class="sb">`some other token`</span>.
</code></pre></div>
<p>I have two questions about this:</p>
<ol>
<li>For expressions that contain subexpressions, we call them "operands" but AFAIK, only the reference uses the term "operand" since we're the only place that needs to be so precise with our terminology. Should we still call the syntactic element an expression, but use the name operand? E.g.</li>
</ol>
<div class="codehilite" data-code-language="markdown"><pre><span></span><code>The syntax for a parenthesized expression is a <span class="sb">`(`</span>, then an operand, the <span class="ge">*enclosed operand*</span>, and then a <span class="sb">`)`</span>.
</code></pre></div>
<p>Would it be more readable if instead, it said "expression" but still named it an operand?</p>
<div class="codehilite" data-code-language="markdown"><pre><span></span><code>The syntax for a parenthesized expression is a <span class="sb">`(`</span>, then an expression, the <span class="ge">*enclosed operand*</span>, and then a <span class="sb">`)`</span>.
</code></pre></div>
<ol start="2">
<li>Should we put "called" before the name? Using the same example as before:</li>
</ol>
<div class="codehilite" data-code-language="markdown"><pre><span></span><code>The syntax for a parenthesized expression is a <span class="sb">`(`</span>, then an operand, called the <span class="ge">*enclosed operand*</span>, and then a <span class="sb">`)`</span>.
</code></pre></div>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>